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REFERENCE GUIDE NOTATIONS AND 
FORMAT CONVENTIONS 


A standard scheme for presenting the general format of BASIC language state- 
ments is employed in this reference guide. The capitalization, punctuation and 
other conventions are listed below: 


[ ] Brackets indicate that the en- 
closed items are optional. 
Brackets do not appear in the 
actual statements. 


Braces indicate that a choice of 
one of the enclosed items is to be 
made. Braces do not appear in 
the actual statements. 


. Ellipses indicate that the preced- 
ing item may be repeated. 
Ellipses do not appear in the ac- 
tual statements. 


Italics \talics indicate generic terms. 
The programmer must supply the 


( 


a 


actual value or wording required. 


See Generic Terms and 
Abbreviations. 


Line number A |ine number is im- 
plied for all BASIC language 
statements. 


Punctuation A\l punctuation 
characters, including commas, 
semicolons, colons, quotation 
marks and parentheses, must 
appear as indicated. 


UPPER CASE Upper case letters 
and words must appear exactly 
as indicated. 


APPLE BASIC VERSIONS 


Applesoft—Comprehensive BASIC 
which permits numeric values 
with fractions. Line numbers 
must be between 0 and 63999. 


Integer BASIC—A version of BASIC 
which limits calculated values to 
a range of 32767 to — 3276/7, 
and does not permit decimal frac- 





tions. Line numbers must be be- 


tween 0 and 32767. 
VIDEO PROMPT CHARACTERS 


Character Language 


* Monitor 
> Integer BASIC 
Applesoft 


GENERIC TERMS AND ABREVIATIONS 


Arg—Argument. 3 

Bn—A byte number. 

col—Low resolution graphics column 
number. O < numeric SxpIpSsiol 
< 39: 

colh—High resolution graphics 
column number. O < numeric ex- 
pression < 279. 

const—Any numeric or string 
constant. 

Dn—A disk drive number. Must be 
specified as D@ or D1. 

expr—Any valid Apple || expression. 

expr$—Any valid Apple II string 
constant, variable or expression. 

exprnm—Any numeric constant, 
variable or expression. 

filename—A disk file name. 

format—Format of BASIC language 


statement common to both Apple- 


soft and Integer BASIC. 
format,ss—Applesoft BASIC format 
of BASIC language statement. 
format,g—|nteger BASIC format of 
BASIC language statement. 
length—|nteger ranging from o 
through 32767 decimal. 
line—A BASIC program line number. 
line,;—The ith line number in a 
BASIC program. 
Lm—Length in bytes. Integer ranging 


in value from 0 to 32767 decimal. : 


APPLE II® is-a registered trademark ns Compute 


PMOL Dai Liss ahe pkey 


memadr—The memory address 
referenced by a numeric expres- 
sion,variable or constant. 
— 6553515 < range < 6553540. 
memloc—the memory location 
specified by an integer constant. 
Ow = range < 6553516 
msg—The message denoted by 
quotes which forms a string. 
nvar—Numeric variable. 
row—Low resolution graphics row 


number. O < numeric expression s 47. 


rowh—High resolution graphics 
row number. O < numeric ex- © 
pression < 191 
Rn—Specified field of a file. 
slot—predefined areas into 
which circuit boards plug. 
Sn—Slot number for input or output. 
O<n</ 
sub—Subscript. 
var—Numeric or string variable in 
Integer BASIC. Numeric, integer 
or string variable in Applesoft. 
varnm—A numeric variable name. 
var(sub)—Any subscripted numeric 
variable in Integer BASIC. Any 
subscripted integer, numeric or 
string variable in Applesoft. 
Wn—A disk volume number. 
OSs 255 


rose 
wat 


ee rn ——oeeese EE 
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VARIABLE NAMING CONVENTIONS 


integer BASIC format F{SL} 

where: 

First character must be a letter. 

Second character to last character 
may be letter(s) or digit(s). 

Last character must be a $ for string 


Applesoft format F{SL} where: 


First character must be a letter. 

Second character is optional and may 
be a letter or digit. 

Last character denotes variable type: 
$ for string variable, % for in- 


teger variable, otherwise real _varlable. | 
variable. Name length may be 1 to 10 
Name length must be 1, 2 or 3 characters. 
characters. 
ARITHMETIC OPERATORS 
‘OPERATION INTEGER BASIC APPLESOFT 

ARITHMETIC 

Exponentation A SN 

Unary Minus — — 

: Multiplication * * 
Division / / 
Division Remainder MOD Not Available 
Addition + aE 
Subtraction — a 

RELATIONAL 
Equal | = = 
Not Equal. if <> or >< 
Less than | < < 
Greater than. = > 
Less than or equal < <= OF Sn< 
Greater than or equal >= >=or=> 
BOOLEAN 
Logical complement NOT NOT 
Logical AND AND AND 
OR 2 OR 


Logical OR 


SYSTEM COMMANDS 


AUTO— Integer BASIC command 
that sets the automatic line 
numbering mode. 
formatip: AUTO fine [, increment ] 

CLR—Integer BASIC command 
that assigns zero values to all 
variables and array elements. 
format)g: CLR : 

CON —Integer BASIC command 
that causes a program to resume 
execution at the next instruction 
following a halt. 
format)p: CON 

CONT—Applesoft command that 
Causes a program to resume 
execution at the next instruction 
following a halt. 
formatas: CONT 


DEL—Eliminates the specified 


program lines. 
format: DEL fine, lines 
FP—Puts the Apple II into Applesoft. 
format: FP[,Dn] [,Sn] [,Vn] 
INT—Puts the Apple I! into Integer BASIC. 
format: INT 
LIS T— Displays all or a specified portion 
of the program currently in memory. 
~ format: LIST line; [, lines] 


line; [t > 3] ; 


- LIST 
forming: lal es — } lines 


MAN—Ends the automatic line 
numbering mode in Integer BASIC. 
format)p: MAN 


MON—Permits the display of disk 
commands and/or data traffic on 
, the video monitor. 








format: MON [C] [,!] LO] 


where: C is specified to display 
disk commands 
| is specified to display 
data flow from disk to 
Apple I! 
O is specified to display 


‘data flow from Apple || 


to the disk 


NEW — Deletes the current program 
and all variables from memory in 
the Apple II. 


format: NEW 
NOMON—Ends the video display of 


disk commands and/or data flow 
- initiated by MON command. 


format: NOMON 


RUN—Executes the current pro- 


gram in memory. If a line number 
is specified, execution com- 
mences at that number, other- 
wise execution begins at the 
lowest numbered line in the 
program. 


format: RUN [/ine] 


SAVE—Saves the program currently 


in memory on cassette or on disk. 
See Input/Output control for formats. 


BASIC LANGUAGE STATEMENTS 


BRANCHING 


CALL—Results in a branch to > 
a machine language subroutine 
at a specified memory location. 


format: CALL memadr 


GOSUB—Results in a branch to 
the indicated /ineé number. A 
return statement causes a 
branch back to the instruction 
following the GOSUB. 


format: GOSUB /ine 
GOTO—Causes an unconditional 

branch to the indicated /ine 

number or the numeric expres- 

sion in Integer BASIC. 

format: GOTO line 

format:|g: GOTO exprnm 
IF-THEN—Causes a branch 

or the execution of a statement 

to occur if the indicated expres- 

sion is true. 

format: IF exor THEN statement 

[:statement .. .] 


THEN 
IF expr { GOTO line 


THEN GOTO 


format)p: IF expr THEN statement 
IF exor THEN [GOTO] line 


ON-GOSUB—Causés a conditional 


Applesoft subroutine call. 
Branch depends upon the com- 
outed or current value of the ex- 
pression. 


formatas: ON exprnm GOSUB 
line [, line .. .J ) 


ON-GOTO—Causés a conditional 


Applesoft branch based upon the 
current or computed value of the 
expression. 


formatas: ON exprnm GOTO line 
[, line ...] 


POP—Causes the most recently ex- 


ecuted GOSUB to be changed to 
a GOTO by removing the return 
location for the last GOSUB 
statement executed. 


format: POP 


RETURN—Results in a program 


branch to the statement im- 
mediately following the most 
recently executed GOSUB 
statement. 


format: RETURN 


ERROR DETERMINATION AND CONTROL 


DSP— Integer BASIC statement 
that displays the changing 
values of a predefined variable 
during program execution. 
format)g: DSP var 

NO DSP—Integer BASIC statement 
that cancels the display mode 
for a predefined variable. 
format)g: NO DSP var 

NO TRACE—Turns off the program 
execution TRACE. initiated by a 
TRACE statement. 


format: NO TRACE 


ONERR GOTO—Applesoft state- 


ment that causes a branch to 
the line number indicated if an 
error occurs in the program. 


formatas: ONERR GOTO /ine 


RESUME—Applesoft statement 


that causes the program to 
resume at the beginning of an 
instruction in which an error 
previously occurred. 


formatas: RESUME 


TRACE— Displays the line number 


of each statement executed. 
format: TRACE 


MEMORY REFERENCE 


CLEAR—Applesoft statement that 
initializes all numeric variables 
and array elements to zero and 


assigns a null value to all strings. 
formatas: CLEAR 





HIMEM—FEstablishes the highest 
location in RAM memory available 
for use by the BASIC program. 


format: HIMEM: exprnm 


LOMEM—Establishes the lowest 
location in RAM memory available 
for use by the BASIC program. 


format: LOMEM: exprnm 


PROCESSING STATEMENTS 


DATA—Applesoft statement that 
creates a list of values to be 
assigned to variables through the 
use of a READ statement. 


format: DATA const [, const .. . ] 


DEF FN—Applesoft statement that 
permits special purpose functions 
to be defined. 


format: DEF FNnvar (arg) = 
exprnm 


DIM—Reserves space in main 
~ memory for an array or string. 


formatas: DIM var(sub[,sub . . . }) 
[,var(sub[,sub ...]).. .] 


format)g: DIM var(sub) [, var(sub) 


END—Causes the program to 
terminate. 


format: END 


FOR— Initiates a loop that repeats 
execution of all instructions 
bounded by the NEXT statement 
until the automatically in- 
cremented variable attains the 
value exprnMs. 


format: FOR varnm = exprnm,, 
TO exprnms [STEP exprnm3] 


LET—Assigns a value to the 
specified variable. 
format: [LET] var = expr 
NEXT—Terminates the loop in- 
itiated by a FOR statement 
format: NEXT varnm [,varnm ... | 
READ—Applesoft statement that 
assigns values from DATA state- 
ments to variables. 
formatas:. READ var[,var.. . | 


REM—Nonexecutable statement. 
that permits remarks to be placed 
in the program. 


format: REM remark 


RESTORE—Applesoft statement 
that resets the DATA list pointer 
to the beginning of the list. 


formatas: RESTORE 

STOP—Applesoft statement that causes 
the program to halt execution. 
formatas: STOP 


WAIT—Applesoft statement that halts 
a program until a specified memory 
location attains a defined value. 


formatas: WAIT memadr, exprnm, 
[L,exornm] 


INPUT /OUTPUT CONTROL 


GENERAL 


GET—Applesoft statement that 
receives one character from the 
keyboard without displaying the 
character. 


formatas: GET var 
IN#—Selects the peripheral s/ot from 


which subsequent input will occur. 


format: IN# s/ot 


INPUT— Optionally displays a 
prompt message and then ac- 
cepts input data, assigning 
values to the variables listed. 


format: INPUT [‘‘prompt 

message’’;| var [, var... ] 
PDL—Function that returns 

‘the current value of the game 


control device. 
format: PDL (exprnm) 


PR#—Selects the peripheral 
slot which will receive subse- 
quent output. 


format: PR# s/ot 


PRINT— Outputs values to 
the display or to other 
designated devices. 


format: [const, expr, expr$, 

exprnm, varnm, var(sub)] 
TAB—Integer BASIC statement 

that positions the cursor to the 


specified column at the current 
line. 


formats: TAB co/ 


CASSETTE CONTROL 


LOAD— Loads the program on 
cassette into memory. 


format: LOAD 


RECALL—Applesoft statement 
that retrieves a numeric array 
from cassette storage. 


formatas: RECALL varnm 


SAVE—Saves the program currently 
in memory on cassette storage. 


‘ format: SAVE 


SHLOAD—Applesoft statement 
that loads a high-resolution 
graphics shape table from 
cassette storage. | 


formatas: SHLOAD | 


STORE—Applesoft statement that 
saves a specified array on 
cassette storage. 


formatas: STORE varnm 





3 


TEXT—Returns display to the 
full-screen text mode from any 
graphics mode. 


format: TEXT 
VLIN— Draws a vertical line from 
rOW;, to rOWp in column co/ on 


the display in the low-resolution 
graphics mode. 


format: VLIN row;, roWs AT col 


VTAB—Positions the cursor to 
the line specified by row in the 
current display column. 


format: VLIN row — 
XDRAW—Applesoft statement that 


draws shape exprnm at the 
designated location. 


formatas: XDRAW exprnm [AT 
colh, rowh] 


BASIC FUNCTIONS 


FUNCTION FORMAT AND DESCRIPTION 


ABS (exprnm)—Returns the ab- 
solute value of a number. 

ASC (expr$)—Returns the ASCII 
code number for the specified 
character. 

ATN (exprnm)—Returns the arctan- 
gent of an angle of exprnm radians. 

CHRS (exprnm)—Returns the char- 
acter (string value) of the speci- 
fied ASCII code. 

COS (exprnm)—Returns the cosine 
of an angle of exprnm radians. 

EXP (exprnm)—Returns the base of 
the natural logarithm (e) raised 
to the specified power. 

FN varnm (exprnm)—Calls the | 
previously defined function varnm 
with the value exprnm assigned. 

FRE (exprnm)—Returns the number 
of bytes of memory available 
for an Applesoft program. 

INT (exprnm)—Returns the integer 
portion of a number. ; 

LEFTS (expr$S, exprnm)—Returns 
the leftmost exprnm characters 
of the string expor$. 

LEN (expr$)—Returns the length of 
the specified string. 

LOG (exprnm)—Returns the natural 


logarithm of the specified number. 


MIDS (expr$, exprnm,, 
[exprnm,])—Returns exprnm, 
characters from expr$, commen- 
cing with character exprnm,. 

PDL (exprnm)—Returns the 
current value of the specified 
game control paddle. 


PEEK (memadr)—Returns the 
decimal value of a specified 
memory location. 

POS (exprnm)—Returns the 
column position of the cursor. 

RIGHTS (expr$, exprnm)—Returns 
the rightmost exprnm characters 
of expr$. 

RND (exprnm)—Returns a 
random number. 

SCRN (co/, row)—Returns the color 
code of the specified coordinates 
when in low-resolution graphics 
mode. 

SGN (exprnm)—Returns +1 if 
exprnm is positive, —1 if 
negative, and 0 if its value is zero. 

SIN (exprnm)—Returns the 
sine of an angle of exprnm radians. 

SPC (exprnm)—Moves the cursor 
exprnm positions to the right. 

SQR (exprnm)—Returns the 
Square root. 

STRS$ (exprnm)—Converts a 
numeric value to a string. 

TAB (exprnm)— Used with the PRINT 
statement to move the cursor 
to the specified column position. 

TAN (exprnm)—Returns the tangent 
of an angle of exprnm radians. 

USR (exprnm)—Causes a branch 
to a machine language 
subroutine indirectly through 
memory locations 10 through 12, 
specified by exprnm. 

VAL (exprnm)—Returns the 
numeric value of a string. 


CONTROL CHARACTER UTILIZATION 





CTRL-B—Places the Apple into the 
version of BASIC in Read Only 
Memory. For the Apple I! Plus 
this places it into Applesoft 


BASIC. 
CTRL-C—Halts a listing. 
CTRL-D— Used in conjunction © 





with appropriate PRINT 
statements to direct output to, or 
receive input from, a peripheral! 
device. 


CTRL-G—Rings the Apple I! bell. 
CTRL-H—Backspace. 
CTRL-J— Generates a linefeed. 
CTRL-K—Boots DOS from the | 


monitor after the appropriate slot 
number is typed. In Monitor 
Mode, substitutes the device ina 
given backplane slot for the Ap- 
ple keyboard for data input. 
CTRL-M— Generates a carriage | 
return. 
CTRL-P— When followed by 
appropriate slot number, boots 
DOS from the Monitor and In- 
teger BASIC. In Monitor Mode, 
diverts all output for the screen 
to an Apple intelligent interface. 
CTRL-S—Temporarily suspends 
the listing of a program until any 
other key is pressed. 





LOW RESOLUTION 
GRAPHICS COLORS 


















COLOR NUMBER COLOR NUMBER 


Black O Brown 
Magenta 1 Orange 
Dark Blue 2 Gray #2 
Purple 3 Pink 

Dark Green 4 Light Green 
Gray #1 5 Yellow 
Medium Blue 6 Aqua 

Light Blue 7 White 


HIGH RESOLUTION 
GRAPHICS COLORS 












8 Black 

9g Green 
10: Violet 
lo White 
(2 Black 
iS Orange 
14 Blue 
15 White 





VIDEO AND GRAPHICS CONTROL 


COLOR— Sets the low-resolution 
graphics color. 


format: COLOR = exprnm 

DRAW—Applesoft statement that 
draws a high-resolution graphics 
shape on the video display. 
formatas: DRAW exprnm [AT 
colh, rowh] 


FLASH—Applesoft statement that 
flashes the video display output. 


formatas: FLASH 
GR—Puts display into low-resolution 


graphics mode of 40 col x 40 rows. 
format: GR 
HCOLOR—Applesoft statement 


that sets the color for plotting in 
the high-resolution graphics mode. 


formatas: HCOLOR = exprnm 


HGR—Applesoft statement 
that puts the video display into 
the high-resolution graphics 
mode of 280 columns x 160 
rows, with a four-line text window. 


formatas: HGR 

HGR2—Sets the display to a full-screen, 
high-resolution graphics mode 
of 280 columns xX 192 rows. 
format: HGR2 


HLIN—Draws a horizontal line 
on the display from col, to cols 
at the specified row in low- 
resolution graphics. 


format: HLIN col, , Colo AT row 
HOME—Applesoft statement 

that clears the display and posi- 

tions the cursor at row 1, column 1. 

formatas: HOME 
HPLOT—Applesoft statement that 

places a dot or draws a line on 


the display in the high-resolution 
graphics mode. 


formatsa,s: 


HPLOT colh, row 

HPLOT TO colh, rowh 

HPLOT colh,;,rowh, TO colhs,rowhs 
[TO colh3,rowh3. . . | : 


HTAB—Applesoft statement that moves 


the cursor to the specified column. 
“formatas: HTAB col 
INVERSE—Applesoft statement 
that puts display output into the 
inverse video mode. 
formatas: INVERSE. 
NORMAL—<Applesoft statement 
that turns off the FLASH and IN- 
VERSE video modes. 


formatas: NORMAL 


PLOT— Displays a point on the 
low-resolution graphics display or a 
colored character in the text window. 


format: PLOT co/, row 


POS—Function that returns the 
column position of the cursor. 


format: POS (exprnm) — 
ROT—Applesoft statement that 


rotates high-resolution shapes 
drawn by DRAW or XDRAW. 


formatas: ROT = exprnm 
SCALE—Applesoft statement that 

sets the size of high-resolution 

shapes drawn by DRAW or XDRAW. 

formatas: SCALE = exprnm 


SCRN—Function that returns 
the color code of the low- 
resolution graphics point at the 
specified coordinates. 


format: SCRN (co/, row) 


$PC—Function that moves the 
Cursor a specified number of 
positions to the right. 


format: SPC (exprnm) 


SPEED—Applesoft statement 
that changes the rate at which 
characters are output to the display. 


format: SPEED exprnm 
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DISK CONTROL 
*format: LOAD filename [; Dn] 


L Sa] [Vn] 


APPEND—Opens a disk file 
positioning the file pointer at the 
LOCK—Protects a disk file from 
deletion until it is unlocked. 


end of the file. 
*format: APPEND filename 
pe eS} Ln] *format: LOCK filename [, Dn] 
BLOAD—Loads a binary disk file [, Sn] L,Vn] 
Starting at the memory location MAXFILES—Permits up to 16 disk 
SPEOuiSG: ; files to be open. 
*format: BLOAD filename nf a é 
[,Amemloc] [,Dn] [,Sn] [, Vn] ormat: MAXFILES limit : 
BRUN—Retrieves, loads and OPEN—Prepares a disk file forpccese 4 
executes a machine language *format: OPEN filename [ (, Dr | £ 
(binary) program. [, Sn} [,Vn] - 
*format: BRUN filename POSITION—Positions the disk file . 
[, Amemloc] [,Dn] [,Sn] [,Vn] pointer Rn fields in front of its v 
BSAVE—Saves a /ength of current position. é 
Apple II's memory in binary *format: POSITION filename [, Rn] ; 
on designated disk file. PR#—Selects designated peripheral 
*format: BSAVE filename, slot to receive output. : 
As L length [, Dn] Sn] *format: PR# slot { | : 
Vn 3 
CATALOG—Provides a list of al Bah er eae fipm : 
files on the specified disk. GET commands recen eden: ‘ 
*format: CATALOG [, Dn] [, Sn] format REAL filename . j 
CHAIN— Integer BASIC statement [; Ra] [, Bn] . if 
ae a aa Pore _ RENAME—Changes the name ., a disk . 
Be ee, : file without changing its contents. é 
Fenian CREE “format: RENAME filename;, ok 
filenames |, Dn][, Sn] [Vn]. ! 
CLOSE—Closes all open disk files . a i 
or a specified open disk file RON bodes angecuicee. ‘ 
r mee program residing on disk storage i 
2 SO eeu vena) *format: RUN filename [, Dn] é 
DELETE—Erases designated file [Sn]fVn] ee " 
ae eo SAVE—Permanently stores program é 
Doe Banat filename on disk with designated filename. : 
[, Dr] |, ai L p *format: SAVE filename [, Dn] . 
EXEC—Permits designated text | [, Sal EL Vals « a “ 
ive (0 gol aLnee'e UNLOCK—Permits file to be changed or 
deleted by removing its locked status. 


*format: EXEC filename [, Rn] 
*format: UNLOCK filename © 


[, Dn] [, Sn] L,Va] 
FP—Retrieves Applesoft from disk [, Dn] [, Sn] [Vn] 
formatas: FP [, Dn], Sn} [Vn] VERIF Y—Checks to insure file “Stee, 

saved correctly on disk. Sage ~~ 


| *format: VERIFY filename 


INIT—Initializes disk by saving 
program in memory on disk 
under designated filename. [, Dn] [, Sn] f,Vn] 
*format: INIT filename [, Dn] WRITE— Designates the disk file 
to which subsequent PRINT 
statements output data. 


[, Sn] [,Vn] 


LOAD—Loads program with 
designated filename from disk 


*Indicates Disk Operating System (DOS) commands which require a PRINT 
statement containing a CTRL-D character in the programmed mode operation 


VIDEO DISPLAY COLOR CONTROLS 


COMPLEMENT COLORS 
COLOR XDRAW COLOR — COLOR’ = XDRAW COLOR 
i 3 Blue 


*format: WRITE filename [, Rn] [, Bn] 


ad ¢ 
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